home *** CD-ROM | disk | FTP | other *** search
/ Aminet 52 / Aminet 52 (2002)(GTI - Schatztruhe)[!][Dec 2002].iso / Aminet / util / cli / HowDif.lha / HowDif / HowDif.doc < prev   
Text File  |  2002-10-14  |  5KB  |  106 lines
  1. The files in this archive are used to compare binary files. The DOS
  2. "compare" utility only reports ten mismatches, then stops comparing.
  3. It is used primarily when there is an assumption that the two files in
  4. question are most likely identical.
  5.  
  6. We had a use for a program that assumed just the opposite; that the two
  7. files were probably quite a bit dissimilar. We needed to know HOW MUCH
  8. they differed and WHERE. So we wrote this program, which does just that.
  9.  
  10. The program knows the Emerson Arcadia 2001 character set, so is
  11. especially useful for comparing ROM images and hunting for easter eggs
  12. for that system, but the program is also useful for more general
  13. purposes.
  14.  
  15. You use it from the command line. Usage is as follows:
  16.  
  17.     1> HowDif <file1> [<file2>]
  18.  
  19. where the arguments are the files you wish to compare. For example:
  20.  
  21.     1> HowDif nibble.bin supergob.bin
  22.  
  23. If only one filename is given, the program merely shows a dump of the
  24. file. All output from the program goes to the standard output, and thus
  25. can be piped or redirected as desired.
  26.  
  27. The primary file is whichever of the two files is smaller, or the
  28. first file specified if their sizes are equal. The contents of the
  29. primary file are shown. Bytes which are different in each file are
  30. shown in black (Amiga) or red (MS-DOS). Bytes which are the same in both
  31. files are shown in white (Amiga) or green (MS-DOS).
  32.  
  33. It is "quick-and-dirty". It is also freeware. The authors
  34. included both the executable (object) code and the source code.
  35. If you are tempted to complain about its lack of nifty
  36. features, save your breath and code them up yourself. ;-)
  37.  
  38. The MS-DOS version requires ANSI.SYS to be running to get a correct
  39. display. It also has significant limits on the sizes of the files which
  40. can be processed, due to the poor memory architecture of MS-DOS. We
  41. suggest use of the superior Amiga version wherever possible. The AmigaDOS
  42. version has no requirements whatsoever, and should in theory work under
  43. any version of AmigaOS from 1.0 onwards.
  44.  
  45. On the left is the hex dump of the primary file, in the middle is the
  46. ASCII representation of the primary file, and on the right is an Emerson
  47. Arcadia 2001 character set representation of the primary file.
  48.  
  49. The ASCII representation shows control characters ($00-$1F and $80-$9F)
  50. as `.'. Note that obviously you will get different ASCII representations
  51. on the Amiga and MS-DOS, due to the differing extended ASCII sets used.
  52.  
  53. The Arcadia uses a 64-character set, shown below. Graphics characters
  54. are represented by lowercase letters. Unknown characters (ie. in the
  55. range $40-$FF) are shown in the Arcadia representation as `.'.
  56.  
  57.     $0123456789ABCDEF
  58.      ----------------
  59. $00:  /\abcdefghijklm    $00          : space
  60. $10: 0123456789ABCDEF    $01-$0F (/-m): graphics characters
  61. $20: GHIJKLMNOPQRSTUV    $38-$3B (n-q): sprites 0-3
  62. $30: WXYZ.,+$nopqrstu    $3C-$3F (r-u): user defined characters 0-3
  63.  
  64. These representations are not guaranteed              $03 (a): ########
  65. to be pixel-accurate but should be                             ########
  66. sufficient to indicate what the symbol                         ########
  67. looks like.                                                    ########
  68.                                                                ########
  69.                                                                ########
  70.                                                                ########
  71.                                                                ########
  72.  
  73. $04 (b): ######## $05 (c): ......## $06 (d): ........ $07 (e): ##......
  74.          ########          ......##          ........          ##......
  75.          ........          ......##          ........          ##......
  76.          ........          ......##          ........          ##......
  77.          ........          ......##          ........          ##......
  78.          ........          ......##          ........          ##......
  79.          ........          ......##          ########          ##......
  80.          ........          ......##          ########          ##......
  81.  
  82. $08 (f): ######## $09 (g): ######## $0A (h): ##...... $0B (i): ......##
  83.          ########          ########          ##......          ......##
  84.          ......##          ##......          ##......          ......##
  85.          ......##          ##......          ##......          ......##
  86.          ......##          ##......          ##......          ......##
  87.          ......##          ##......          ##......          ......##
  88.          ......##          ##......          ########          ########
  89.          ......##          ##......          ########          ########
  90.  
  91. $0C (j): .......# $0D (k): #....... $0E (l): ######## $0F (m): ########
  92.          ......##          ##......          #######.          .#######
  93.          .....###          ###.....          ######..          ..######
  94.          ....####          ####....          #####...          ...#####
  95.          ...#####          #####...          ####....          ....####
  96.          ..######          ######..          ###.....          .....###
  97.          .#######          #######.          ##......          ......##
  98.          ########          ########          #.......          .......#
  99.  
  100. URL:   http://www.users.bigpond.com/james.jacobs/amigan.html
  101. EMail: amigansoftware@abime.net
  102.  
  103.                                         Enjoy!
  104.                                         James Jacobs and Ward Shrake
  105.  
  106.